7.3.1 建立數位幣限定金額掃碼支付訂單

#簡單描述：數位幣充值業務接口，用戶透過掃描二維碼的方式將 USDT（Tether）充值到他們的數位錢包帳戶（市場匯率）

要求方式: POST
請求介面: https://网关域名/wallet-trade-merchant/v1/receive/blockchain/fixed/create
請求媒體類型( JSON 資料格式 )Content-Type: application/json

請求參數

參數名稱	類型	必填	參數意義	參數說明
`key`	`string`	是	商家 key	apiKey
`localOrderId`	`string`	是	商家平臺本地訂單號碼	商家平臺本地產生唯一訂單號碼
`localUserId`	`string`	否	商家平臺本機使用者ID	商家平臺本機使用者ID
`notifyUrl`	`string`	否	回呼位址	下單成功後，由 API 回呼通知商家的位址（回調詳情參考文件3）
`successRedirectUrl`	`string`	否	跳轉位址	成功後自動跳轉位址
`currency`	`string`	是	幣種	計價幣種(錢包幣種)
`userCurrency`	`string`	是	幣種	需要用戶支付的幣種(錢包支援數位幣種)
`amount`	`number`	是	金額	訂單計價金額
`isBlockchain`	`boolean`	否	是否回傳區塊鏈資訊（預設false）	當為true時，回呼請求會攜帶訂單鏈上交易資訊
`networkLimits`	`array`	否	主網	指定的支付主網，如 TRON、BSC、POLYGON、ETHEREUM
`expireSecond`	`Long`	否	過期時間戳記（秒）
`sign`	`string`	是	簽章	詳情請見簽章演算法

請求 json 範例

{
  "key": "dNNTJZpgFVWlYrVv",
  "localOrderId": "CONAN-TES1225662",
  "userCurrency": "USDT",
  "currency": "CNY",
  "amount": 10,
  "networkLimits": ["TRON", "BSC"],
  "sign": "8b949190830deb3acf5fd356f2424c72"
}

回應 json 範例

{
  "code": 0,
  "success": true,
  "message": null,
  "data": {
    "orderId": 474103463461061,
    "localUserId": null,
    "localOrderId": "CONAN-TES1225662",
    "orderType": "PAYMENT",
    "orderBizType": "PAYMENT_FIXED_DIGITAL_SCAN",
    "paymentUrl": "https://dxpay.dxstudio.org/fixed-amount-pay/S8hQJJWtWW2GZqLXZc9Nm8Xf32tVDoL44jYqJ59mcrMLy1Zr3RKAu4NVmLzg",
    "publicKey": "S8hQJJWtWW2GZqLXZc9Nm8Xf32tVDoL44jYqJ59mcrMLy1Zr3RKAu4NVmLzg",
    "currency": "CNY",
    "userCurrency": "USDT",
    "amount": "10",
    "userReceivableAmount": "1.49",
    "rate": "6.69220484",
    "rateExpression": "1USDT≈6.6922CNY"
  }
}

返回的 paymentUrl 彈出付款頁面，如下圖：

![img](/dx-docs/7- 7、数字币代收（充值）/7.3 数字币限定金额扫码支付/usdt.jpg)

回應data 參數說明

參數名稱	類型	參數意義	參數說明
`orderId`	`string`	訂單 ID
`localUserId`	`string`	商家本地用戶 ID
`localOrderId`	`string`	商家本地訂單號碼
`orderType`	`enum`	訂單類型	`PAYMENT:支付订单 \| WITHDRAW:提款订单`
`orderBizType`	`enum`	訂單業務類型	orderBizType 類型說明如下
`paymentUrl`	`string`	付款位址
`publicKey`	`string`	金鑰	公共存取金鑰
`currency`	`string`	訂單幣種
`userCurrency`	`string`	用戶支付幣種
`amount`	`string`	訂單金額
`userReceivableAmount`	`string`	用戶應付金額
`rate`	`string`	匯率
`rateExpression`	`string`	訂單匯率表達式

orderBizType 類型說明：

1、PAYMENT_WALLET_SCAN MINPAY錢包掃碼支付 2、PAYMENT_TRANSFER 數位幣綁定地址直充 3、PAYMENT_ANY_DIGITAL_SCAN 數位幣任意金額掃碼支付 4、WITHDRAW_WALLET 提款至MINPAY錢包 5.WITHDRAW_ANY_DIGITAL_WALLET 提款數位幣至任意錢包 6、PAYMENT_FIXED_DIGITAL_SCAN 數位幣限定金額掃碼支付 7、BATCH_PAY 大量代付

回呼返回 json 資料

預設所有回呼參數參與驗簽，回呼參數詳情請看回呼

回呼 data

{
  "amount": 11,
  "bizType": "PAYMENT_FIXED_DIGITAL_SCAN",
  "blockchain": {
    "network": "TRON",
    "receiverAddress": "TA1jptT16DssYWVGdVyFWxonku6hWK7En3",
    "senderAddress": "TPutFhYUQnrRxHSmKVwjp55vgk9QY6r5nS",
    "txId": "24d0d0e5d417bd2195c45d64724760ae47fc3b359ee31c5fedf25b40f3584b36"
  },
  "currency": "CNY",
  "key": "h3cS7dBltRU4W1wD",
  "localOrderId": "2820",
  "merchantActualAmount": 8.86,
  "merchantCurrency": "CNY",
  "merchantId": 303122065665,
  "merchantPaidAmount": 10.98,
  "merchantUserId": "97",
  "notifyTime": 1731572168370,
  "orderCreateTime": 1731572133082,
  "orderId": "273124814912907",
  "sign": "699806308a9e055114c378671b0d2a15",
  "status": "SUCCESS",
  "type": "PAYMENT",
  "userAmount": 1.55,
  "userCurrency": "USDT",
  "userReceivableAmount": 1.55
}

當您收到回呼通知後，請在處理完成後直接返回字串 success，表示已成功接收並處理該訊息。系統在收到 success 回應後，將不再對該筆回呼進行重複發送。若未收到期望回應（未回傳 success 或回傳異常），系統將依照階梯式重試機制重新傳送回呼通知，最多重試 14 次。當前重試時間間隔依序為： 15s, 15s, 30s,180s, 600s, 1200s, 1800s, 1800s, 1800s,3600s,10800s,10800s,21600s, 21600s

請求參數​

請求 json 範例​

回應data 參數說明​

orderBizType 類型說明：​

回呼返回 json 資料​